home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Auge 4000 / Auge 4000 #78 (1994-04-30)(Amiga User Gruppe Einzugsgebiet 4000).zip / Auge 4000 #78 (1994-04-30)(Amiga User Gruppe Einzugsgebiet 4000).adf / Text-WandlerV3_5 / English / Text-Wandler.DOC < prev    next >
Text File  |  1994-03-27  |  22KB  |  655 lines

  1.  
  2.  
  3.                Text-Wandler V3.5
  4.              <><><><><><X><><><><>
  5.                © 24.4.1992 by Kai Seidel
  6.  
  7.  
  8. Introduction:
  9. *************
  10.  
  11. Beside my Amiga, I have a PC for the work with my mailbox programs & texts.
  12. Therefore  it  is  annoying  that the Amiga ASCII-table does not correspond
  13. with  the  IBM-table.The  texts of the Amiga are (almost) not readable on a
  14. MS-DOS  compatible.   For  that reason, I decided to write a text converter
  15. which  converts  the texts between both of the ASCII-formats.  Equally, the
  16. different  end  of  the lines between PC and Amiga is a problem.  The Amiga
  17. uses a $0a (=linefeed) and the PC a $0d0a (=carriage return + linefeed) for
  18. the end of line.
  19.  
  20.  
  21. The Program:
  22. ************
  23.  
  24. My  program solves this problem.  It is completely written in assembler and
  25. consequently  uses  the  FULL  speed of the computer.  There will always be
  26. loaded  16KByte (=16384 Bytes) from the text file which is to be converted,
  27. translated  and saved under the new name again.  However, there will not be
  28. only  allocated  16KByte  memory by the program.  Approximately 80 KByte of
  29. RAM-storage  should  be free altogether.  (Almost?) Every typing error will
  30. be caught.
  31. In  order  to  attain  a  rather high speed, 8 routines separated from each
  32. other  were  integrated,  two  for  the  conversion of texts between PC and
  33. Amiga, another two for the conversion of texts between Amiga and Atari, one
  34. for the conversion into normal ASCII-characters (Ä=Ae), one for the removal
  35. of  unused  spaces  and  tabs,  one  for  the removal of inconvenient ANSI-
  36. sequences  and  one for the use of an own conversion table.  Three complete
  37. ASCII-tables  which  make  it  possible without problems to translate other
  38. characters like >ÄÖÜäöoß< as well are also included in the program.
  39. The program possesses a STARTUP-code for the version 2.0 and higher.  Since
  40. that it can be used from both the CLI/SHELL and the Workbench!
  41.  
  42. The program converts since version 1.4 the following special characters:
  43.  
  44.    ÄÖÜäöüߢ£¡¤¥§ª«¬­°±²µ¶º»¼½¿ÅÆÇÉÑàáâåæçèéêëìíîïñòóôøúûÿ
  45.  
  46. Those  characters  are transferred correctly in both conversion-directions.
  47. Unfortunately,  these  are the only special characters, which are available
  48. in both, the MS-DOS- and the AMIGA-ASCII-table.
  49.  
  50. During the process of converting, the current position of the text-position
  51. is displayed.
  52.  
  53.  
  54. System requirements:
  55. ********************
  56.  
  57. Actually  none.   The  text-converter  should  be  able  to  run with every
  58. configuration.  One requirement is certainly kickstart 1.2 or higher!
  59.  
  60. Kickstart/WB 2.x (Intuition/Gadtools V37 or higher):
  61.   >ASL.LIBRARY< is required for the file requester.  These MUST be found in
  62.   the "LIBS:" directory of the boot disk.
  63.  
  64. Kickstart/WB 1.2/1.3:
  65.  
  66.   >REQ.LIBRARY<  is required for the file requester.  If it is not found in
  67.   the  LIBS:   directory,  you  should  look on the fish-disks.  Before the
  68.   start,  this  library  must  be  copied  into the LIBS:  directory of the
  69.   workbench disk or the boot partition!
  70.  
  71.  
  72. Installation:
  73. *************
  74.  
  75. Copy the files 
  76.  
  77.      Text-Wandler
  78.  and Text-Wandler.info
  79.   
  80. into any directory and start the program from CLI/SHELL or Workbench.
  81.  
  82.  
  83. WORKBENCH-Start:
  84. ****************
  85.  
  86. By  clicking  the  text-converter-icon  twice, you start the text-converter
  87. with the intuition-interface (in Workbench-mode).
  88.  
  89. According  to  your  kickstart/workbench  version, the text-converter opens
  90. different screens and windows.
  91.  
  92. The use under kickstart/workbench 1.2/1.3:
  93. ******************************************
  94.  
  95. The shareware-version opens an info-window at first.  The window disappears
  96. by clicking its CLOSE-Gadget (=Close-lever) once.
  97. Now the actual text-converter window appears with the following gadgets:
  98.  
  99.  - Get Source
  100.  
  101.    If  you  click  on  this  gadget,  the file requester of the Req.library
  102.    opens.  Now, with its help, you can choose comfortably by mouse the text
  103.    that is to be converted.
  104.  
  105.  - Gadget right of >Get Source<
  106.  
  107.    This  is  a  so called string-gadget.  If you choosed the text-data with
  108.    the  help  of  the  file  requester, the complete file name and the path
  109.    appears  here.  You can also use your keyboard by clicking on the gadget
  110.    and type in the name of the file directly.
  111.  
  112.  - Get Destination
  113.  
  114.    Here you can choose again the data name of the completely converted file
  115.    with the help of the file requester.
  116.  
  117.  - Gadget right of >Get Destination<
  118.  
  119.    Here  again  the  appertaining  string-gadget for the target-data-name +
  120.    path
  121.  
  122.  - Get trans table
  123.  
  124.    If  this  gadget  is  clicked,  the  file  requester of the Req.library.
  125.    opens.  With its help, you choose the conversion-table (more information
  126.    will be given later).
  127.  
  128.  - Gadget right of >Get trans table<
  129.  
  130.    Here again the appertaining string-gadget for the table-name with path
  131.  
  132.  - Gadget right of >Mode<
  133.  
  134.    Here you can choose the mode to convert the text with.
  135.  
  136.  - OK and STOP
  137.  
  138.    When  source,  destination  text  and table is defined you can start the
  139.    conversion by clicking this gadget.  While converting the OK-gadget will
  140.    change  into  STOP.  You finally can stop the conversion by clicking the
  141.    STOP-gadget.
  142.  
  143. Next to >Position:< the actual converting-position will be displayed.
  144.  
  145. If errors occur they will be shown at >Status<.
  146.  
  147.  
  148. The use under Kickstart/Workbench 2.x
  149. *************************************
  150. The  Text-Wandler  opens an own screen by using the actual screenmode and a
  151. window  in  which  the  gadgets and file requesters will be displayed.  The
  152. shareware-version first opens an info-window.  This window can be closed by
  153. clicking the "CONTINUE" gadget.
  154.  
  155. The window consists of the following gadgets:
  156.  
  157.  - Select Source (hotkey 'S')
  158.  
  159.    By  clicking  this  gadget  a req.library file requester will be opened.
  160.    Now you can choose the text to be converted.
  161.  
  162.  - Gadget under >Sourcefile< (hotkey 'O')
  163.  
  164.    This  is  a string-gadget.  If you choose the text by the file requester
  165.    the  filename  with  the  path will be displayed.  You can also type the
  166.    name  of the textfile into this gadget without using the file requester.
  167.    The cursor appears if you click on it.
  168.  
  169.  - Select Destination (hotkey 'D')
  170.  
  171.    Here  you  can  choose  the  destination  filename  by  using  the  file
  172.    requester.
  173.  
  174.  - Gadget under >Destinationfile< (hotkey 'E')
  175.  
  176.    The  filename  of  the destination file will be shown and can be fitted.
  177.    The source text will be converted later to this filename.
  178.  
  179.  - Select Table (hotkey 'T')
  180.  
  181.    Is  this  gadget  clicked, a file requester appears and asks you for the
  182.    filename of the table.
  183.  
  184.  - Gadget under >Translation Table< (hotkey 'R')
  185.  
  186.    Here again the string-gadget for the filename.
  187.  
  188.  - Gadget under >Mode< (hotkey 'M')
  189.  
  190.    Here you can choose the mode to convert the text with.
  191.  
  192.  - Start/Stop (hotkey 'A')
  193.  
  194.    When  source,  destination and table filenames are fitted, you can start
  195.    the  conversion  by clicking this gadget.  While operating you can abort
  196.    the conversion by clicking this gadget again.
  197.  
  198. You can select gadgets by using their hotkeys!
  199.  
  200. Next to >Position:< the actual text-position will be displayed.
  201.  
  202. Are there any errors, a message will be displayed at >Status<.
  203.  
  204. To quit the program click on the close-gadget.
  205.  
  206.  
  207. CLI/SHELL-Usage:
  208. ****************
  209.  
  210. Text-Wandler [-i/-a/-m/-t/-s/-c/-u/-r/-z]
  211.          [-o] [-n] <sourcefile> <destfile> [table]
  212.  
  213. <> arguments
  214. [] options
  215.  
  216.  
  217. Arguments:
  218. **********
  219.  
  220. The arguments <sourcefile> and <destfile> MUST be given or an error message
  221. will  be  the  result.  The sequence of giving the filenames must be right,
  222. too.
  223.  
  224. When  there  are spaces in the filename they must be set in quotation marks
  225. (see examples later).
  226.  
  227. Additionally  to  that,  instead  of giving a destination filename, you can
  228. declare  a path, in which the source file will be converted with the source
  229. filename.
  230.  
  231. Options:
  232. ********
  233.  
  234. Only one of the following nine options can be choosed:
  235.  
  236.  -i  The  text  is  given in Amiga-ASCII-format and is to be converted into
  237.      MS-DOS-ASCII-format which includes special character conversion.
  238.  
  239.  -a  The  text  is given in MS-DOS-ASCII-format and is to be converted into
  240.      Amiga-ASCII-format.
  241.  
  242.  -t  The  text  is  given in Amiga-ASCII-format and is to be converted into
  243.      Atari-ST-ASCII-format.
  244.  
  245.  -m  The text is given in Atari-ST-ASCII-format and is to be converted into
  246.      Amiga-ASCII-format.
  247.  
  248.  -s  The  text  is  either  given  in  Amiga-  or MS-DOS-ASCII-format.  All
  249.      unnecessary spaces or tabs at the end of lines will be deleted (take a
  250.      look at the limitation of the shareware Version).
  251.  
  252.  -c  Vowels  i.e.   "ÄÖÜ",  will  be translated into usual ASCII-characters
  253.      "AeOeUe".
  254.  
  255.  -u  The  Text-Wandler  uses  the  Workbench-Mode.   That means a window is
  256.      opened in which several options can be chosen by mouse.
  257.  
  258.  -r  ANSI-Sequences will be deleted out of Amiga-texts by that.
  259.  
  260.  -z  Uses  an  own  table for conversion.  If you use this option, you MUST
  261.      give  a  third filename refering the translation table (take a look at
  262.      the limitation of the shareware Version).
  263.  
  264. If  none  of  the  listed  options  is  chosen,  the  text is automatically
  265. converted into MS-DOS-ASCII-format.
  266.  
  267. The last two options can be given if necessary:
  268.  
  269.  -o  If  the destination filename already exists, this option will cause no
  270.      security check whether the file should be erased.
  271.  
  272.  -n  Turns  off  the  display of the current text-position while converting
  273.      (saves time).
  274.  
  275.  
  276. Examples:
  277. *********
  278.  
  279. For illustration some examples:
  280.  
  281. 1.   Text on disk in DF0:  named "Test.txt" is in Amiga-ASCII-format and is
  282.      to  be  converted  into MS-DOS-ASCII-format.  The converted text shall
  283.      get  the  name  "Hello.txt"  and  be  laid  into  RAM:.  Therefore the
  284.      following usage is necessary:
  285.  
  286.       Text-Wandler -i DF0:Test.txt RAM:Hello.txt
  287.  
  288. 2.   Text  on harddisk DH0:  named "Happy Day.txt" is in Amiga-ASCII-format
  289.      and  is to be converted into MS-DOS-Format on Disk DF2:  with the same
  290.      name.
  291.  
  292.       Text-Wandler -i "DH0:Happy Day.txt" DF2:
  293.  
  294. 3.   Text  on Disk in PC0:  named "Read.txt" is in MS-DOS-Format and is to
  295.      be  converted into AMIGA-Format on harddisk WORK:  with the name "Read
  296.      Me.txt".   A possibly existing file with the same name ("Read Me.txt")
  297.      may be deleted.
  298.  
  299.       Text-Wandler -a-o PC0:Read.txt "WORK:Read Me.txt"
  300.  
  301. 4.   Text  on RAM:  named "Temp.txt" in Amiga- or MS-DOS-ASCII-format.  The
  302.      text  was  just  edited  and  any  existing  spaces  or tabs should be
  303.      deleted.   The  converted  file  shall  be named "RAM:Ready.txt".  For
  304.      speed   up,  the  display  of  the  current  text-position  should  be
  305.      suppressed.
  306.  
  307.       Text-Wandler -s-n RAM:Temp.txt RAM:Ready.txt
  308.  
  309. 5.   Text    on   disk   DF2:    named   "Text-Wandler.DOC"  in  Amiga-  or
  310.      MS-DOS-ASCII-format  possesses vowels.  Those should be converted into
  311.      normal characters to disk in DF1:  named "TXTWND.DOC".
  312.  
  313.       Text-Wandler -c DF2:Text-Wandler.DOC DF1:TXTWND.DOC
  314.  
  315. 6.   You wish to start the Text-Wandler in workbench mode.
  316.  
  317.       Text-Wandler -u
  318.  
  319. 7.   A capture-file (e.g. from JRComm) consists of annoying ANSI-sequences,
  320.      which  are  to  be  deleted.   The file is named "DF1:Example.CAP" and
  321.      shall be converted to RAM:
  322.  
  323.       Text-Wandler -r DF1:Example.CAP RAM:
  324.  
  325. 8.   A text shall be converted by an own defined table.  The table is named
  326.      "t:Tab.tab".  The text to be converted is on RAM:  and named "Hello Mr
  327.      XYZ".    The   converted   text   shall   be  on  T:   with  the  name
  328.      "Happy_Day.txt".
  329.  
  330.       Text-Wandler -z "RAM:Hello Mr XYZ" T:Happy_Day.TXT t:Tab.tab
  331.  
  332.  
  333. The conversion Table:
  334. *********************
  335.  
  336. Here  it  is  -  the  Text-Wandler  version,  many  people have waited for!
  337. Version  3.0  and  higher, now the Text-Wandler converts your texts by your
  338. own will.
  339.  
  340. The  CLI-option  "-z" and the conversion-mode "Use conversion table" need a
  341. so called translation-table.  This has got the following structure:
  342.  
  343. "abc"="def"; /* converts "abc" to "def" */
  344. 34,"Hello",34="Hi"; // "Hello" is converted into "Hi"
  345. $0a=$0d,$0a; /* The Amiga-Linefeed will be replaced by
  346.         a MS-DOS carriage return and linefeed */
  347. .....
  348. .
  349. .
  350. etc.
  351.  
  352. There  may be strings, hex- and decimal-numbers given.  Strings must be set
  353. in quotation marks and hex-numbers need a "$" before the number is given.
  354.  
  355. The "=" character divides the sequence that shall be converted.  At the end
  356. of a declaration a semicolon ";" is needed.
  357.  
  358. Comments  are also possible.  Either normal C or C++ comments may be given.
  359. Normal  C  comments  begin with "/*" and end with "*/".  C++ comments begin
  360. with "//" and end with the end of a line.
  361.  
  362. For better understanding some examples:
  363.  
  364. - The  character  "a"  shall  be  converted  to  an  "A".   Therefore  more
  365.   combinations can be given:
  366.  
  367.   $61=$41;
  368.      or
  369.   "a"="A";
  370.      or
  371.   97=$41;
  372.     etc.
  373.  
  374. - The characters "-" and "+" shall be exchanged:
  375.  
  376.   $2B=$2D;
  377.   $2D=$2B;
  378.      or
  379.   "-"="+";
  380.   "+"="-";
  381.     ect.
  382.  
  383. - All spaces shall be replaced by a "_":
  384.  
  385.   $20=$5f;
  386.      or
  387.   32="_";
  388.  
  389. - Every "!" shall be deleted:
  390.  
  391.   "!"=;
  392.  
  393. You can generate your own ASCII-character set!
  394.  
  395. An important hint:
  396. By  defining  your own tables, take care of definitions that begin with the
  397. same  sequences.   You have to define the longer sequence before an equally
  398. shorter.   This  is  because Text-Wandler generates a table that is scanned
  399. from  the start, and if a sequence agrees with the character to be changed,
  400. the following sequences will be ignored!  An example follows:
  401.  
  402. "+"="-";
  403. "++"="+";
  404.  
  405. If  you  give  this  sequence  to Text-Wandler, all plus-characters will be
  406. changed  into minus-characters, even if two characters follow.  The correct
  407. spelling is as follows:
  408.  
  409. "++"="+";
  410. "+"="-";
  411.  
  412.  
  413. Error messages:
  414. ***************
  415.  
  416. For the following problems/errors there are messages:
  417.  
  418. - No input is given
  419. - Wrong/No option(s) is(/are) given
  420. - No filename or none given
  421. - Source- or destination-filename are equal *)
  422. - Source-file does not exist
  423. - Destination-file already exists *)
  424. - Destination-path not allowed
  425. - Not enough free memory
  426. - Error while reading/writing from/to source-/destination-file
  427. - Incorrect line in table will be displayed
  428.  
  429. Attention !!! The marked "*)" error messages will be ignored by
  430. using the Workbench-mode!
  431.  
  432.  
  433. Hints for converting:
  434. *********************
  435.  
  436. If  you  convert  large  texts,  it  will be expedient to copy them to RAM,
  437. because the text will be read faster from RAM than from disk or harddisk.
  438.  
  439. All  switches  can be set on any position.  Only the succession of source-,
  440. destination- and table-filename must be given !
  441.  
  442.  
  443. Known bugs:
  444. ***********
  445.  
  446. None! Most bugs always appear if you don't need them!
  447.  
  448. I always try to remove bugs if they get known.
  449.  
  450. If you find a bug, please let me know!
  451.  
  452.  
  453. For the future:
  454. ***************
  455.  
  456. - Text-Wandler recognizes, what ASCII-format the source-file consists of
  457. - 8 spaces will be converted to a tab
  458. - Table-converting-routine will be improved
  459.  
  460.  
  461. Important information:
  462. **********************
  463.  
  464. There  is  neither  a  guarantee  for  the  100% working capability of this
  465. program  nor  does  the programmer take any responsibility for consequences
  466. that result of wrong commands or the general usage of the program.  You use
  467. this software on your own risk.
  468.  
  469.  
  470. If errors appear:
  471. *****************
  472.  
  473. Please send a message with a complete error-report to the following address:
  474.  
  475. Kai Seidel
  476. Ringstraße 63
  477. 83355 Grabenstaett
  478. WEST-GERMANY
  479.  
  480. or via EMail: +49 8661-658 (friday to sunday 24h online; 1200-14400 baud)
  481.  
  482. Or if even you have ideas to be installed into Text-Wandler write to that
  483. address!
  484.  
  485. I'm also reachable via Zerberus-Net: SYSOP@CHIEMGAU.zer.sub.org.
  486.  
  487.  
  488. Restrictions of the shareware version:
  489. **************************************
  490.  
  491. The  space  and tab deleting routine only can convert Amiga-ASCII-texts and
  492. only  spaces  will  be  deleted!   The  "ß"  won't be converted by the "-c"
  493. option.
  494.  
  495. If  you start Text-Wandler in Workbench-mode, a nerv-requester appears that
  496. won't be displayed in the registered version.
  497.  
  498. The  "ANSI-Remove"-  and  "Use  translation table"-mode only can be used in
  499. Workbench-Mode.
  500.  
  501. If  you  use your own table, only a length of 32 characters of the table is
  502. allowed.   All following characters won't be read.  This can cause an error
  503. message  if  you  define a sequence that is longer than 32 characters.  The
  504. following line will be read and the source-text be converted with:
  505.  
  506. "ä"="ae";"ö"="oe";"ü"="ue";
  507.  
  508. These  are  28  characters.   I think this will be enough for testing Text-
  509. Wandler !
  510.  
  511. All these restrictions are removed in the registered version!
  512.  
  513.  
  514. Shareware fee:
  515. **************
  516.  
  517. If  you  like  this program or use it regularly, please pay 10 US Dollar or
  518. any equal amount in your currency.
  519. For  registration  use the "Registration.TXT".  Print it and send it filled
  520. out  back  to  me.  If you are not able to print out the registration form,
  521. write  your address, telephone number, computer- configuration and your way
  522. of  paying  to  a  sheet  of paper and send it to the address listed in the
  523. registration  form.  For bank transfer use the bank information also listed
  524. in the registration form.
  525.  
  526.  
  527. As  a  registered  user  of  Text-Wandler,  you're then entitled to own the
  528. newest, registered version!
  529.  
  530.  
  531. Copyright information:
  532. **********************
  533.  
  534. Shareware version:
  535.  
  536.   The  Program  may  only  be  copied with this manual and the registration
  537.   form.   The  manufacturing-/copy-fee mustn't be greater than 4 US Dollar!
  538.   The package may be adapted by any PD-groups ,e.g.  FRED FISH.
  539.  
  540. Registered version:
  541.  
  542.   The  registered version mustn't be copied, rented or published or even be
  543.   put on PD-Disks to be offered other people!
  544.  
  545.  
  546.   The Req.Library is Copyright by Colin Fox and Bruce Dawson!
  547.  
  548.   The ReqTools.Library is Copyright by Nico François!
  549.  
  550.  
  551. Special Thanks:
  552. ***************
  553.  
  554.  ...   to  my  brother Roger and to his friend Sebastian Schmucker for this
  555.        translation and for correcting the documents!
  556.  
  557.  ...   to  Ralph  Babel  and  Garry  Glendown  for  helping  me, when I had
  558.        questions about programming.
  559.      
  560.  ...   to Colin Fox and Bruce Dawson for their great req.library!
  561.  
  562.  ...   to Nico François for his great ReqTools.library!
  563.  
  564.  ...   to  Commodore  for  this  great machine, because ONLY AMIGA MAKES IT
  565.        POSSIBLE !!!
  566.  
  567.  
  568. Development phases:
  569. *******************
  570.  
  571. V1.0    First version from 04/25/92
  572. V1.1    Version from 05/01/92
  573.     -supports filenames with spaces by using quotation marks
  574.     -tests, if two equal filenames are given
  575. V1.2    Version from 07/03/92
  576.     -big bug removed when converting to MS-DOS-ASCII-format
  577.     -memory-allocation-routine shifted -> shorter conversion
  578.      time
  579.     -additional routines improved
  580. V1.2a   Version from 07/06/92
  581.     -wrong USAGE-Text corrected
  582. V1.3    Version from 07/11/92
  583.     -conversion-puffer has been decreased to 16384 bytes
  584.     -further conversion bug removed; carriage returns weren't
  585.      converted correctly while translated into Amiga-ASCII-format
  586.     -additional routines improved -> very short conversion times
  587.      when converting from harddisk to harddisk
  588.     -bug that prevent a correct running under Kickstart 1.2/1.3
  589.      has been removed
  590. V1.4    Version from 07/21/92
  591.     -additional special-characters are also converted
  592. V1.5    Version from 07/24/92
  593.     -the chars "|" and "ª" were exchanged uncorrectly and, in version
  594.      1.4, corrected; very necessary if you convert c-sources!
  595.     -if you give a directory instead a filename as a destination, the
  596.      text will be converted to that directory with the source-name
  597.     -security check added on a perhaps existing destination-file
  598.     -new switch (-o) added; turns off the security check listed before;
  599.      if there exists already a file with the same destination-name,
  600.      it will be overwritten by the new one
  601.     -the text will be converted to MS-DOS-ASCII-format if there is
  602.      no switch given
  603. V1.6    Version from 08/11/92
  604.     -shorter code because of better programmed routines
  605.     -the Text-Wandler can be aborted now by pressing CTRL-C
  606.     -the program displays now the actual byte-position while
  607.      converting; the display can be turned off by using the "-n"
  608.      switch
  609.     -new routine added for deleting unused spaces and tabs at the end of
  610.      a line
  611. V1.7    Version from 08/13/92
  612.     -the first character of the source-text was ignored when
  613.      converting to Amiga-ASCII-format
  614.     -vowels are now converted to usual ASCII-characters, e.g.
  615.      "ö" to "oe"
  616. V2.0    Version from 09/12/92
  617.     -Workbench-mode added; you can control all functions via
  618.      mouse now
  619. V2.1    Version from 09/23/92
  620.     -If you convert to Amiga-ASCII-format the end of lines will be
  621.      checked for a carriage return and a linefeed
  622.     -Text-Wandler now can remove ANSI-sequences from any texts
  623. V2.2    Version from 11/22/92
  624.     -when using Text-Wandler under Kickstart 1.x, the string-
  625.      gadget didn't work correctly; removed that bug
  626.     -conversion from Amiga- to Atari-ASCII-format added
  627.     -version-string added; the version-number now can be displayed
  628.      by using the "Version" command
  629.     -the usage text will now stop being displayed after every 12
  630.      lines and will wait until the return-key is pressed
  631. V2.2a   Version from 11/30/92
  632.     -more bugs corrected
  633.      + the ANSI-remove-routine didn't work correctly
  634.      + the security check didn't read the following return-key
  635. V2.3    Version from 12/06/92
  636.     -the "STOP"-gadget had a bug; it caused a reset
  637.     -too large ANSI-sequences weren't deleted
  638. V3.0    Version from 01/15/93
  639.     -OS 2.x user interface added
  640.     -Text-Wandler can now convert texts using your own conversion
  641.      table
  642.     -string-gadget-bug when using Kickstart 1.x corrected
  643. V3.1    Version from 02/22/93
  644.     -The usage text now adapts on the height of the CLI-/Shell-
  645.      window; if it is full it will wait for a return-key
  646.     -when using the Workbench-mode, some conversion-routines
  647.      were exchanged - now corrected
  648. V3.5    Version from 03/27/94 Programlength: 23132 (english version)
  649.                          23576 (german version)
  650.     -now there is a German and an English version
  651.     -the translation table may now consist of decimal numbers
  652.      and of strings
  653.     -characters are no longer converted 1:1; definitions may
  654.      now have any length
  655.